Skip to content

Add PostgreSQL/TLS self-hosting with recoverable task creation - #8887

Merged
huangruiteng merged 7 commits into
mainfrom
codex/product-pg-compose-acl-20261117
Nov 17, 2026
Merged

huangruiteng merged 7 commits into
mainfrom
codex/product-pg-compose-acl-20261117

Conversation

@loopx-agent

@loopx-agent loopx-agent commented Nov 16, 2026 •

Copy link
Copy Markdown
Collaborator

Goal And Delivered Outcome

已有 Docker Engine 和 Compose 的操作者可以从固定源码生成自托管包,运行 ./start.sh 初始化 PostgreSQL 16、受限数据库角色、私有 CA 和客户端,再通过 CLI 交接任务、读回状态和恢复回执。

默认许可的 todo_add 在提交后丢失响应时,远端服务现在复用创建操作自己的解码规则生成完整历史响应,保留原回执和摘要;严格客户端可恢复,重放不重复创建。打包演练也改为使用服务端自身的两个租约时间戳和相对等待,避免宿主与服务时钟偏差造成误报。20 秒租约、21 秒上限和后续权限检查均保留。

Related to #8747 / #8765;目标分支 main。修复依据:创建恢复评审、时钟偏差复评。

Author Declaration

  • Written by: model_agent — OpenAI Codex, GPT-6 family.
  • Specification: docs/reference/remote-authority-task-service-v0.md at a92b123749e7d2ef0c80e33fa88e40a4c0f572aa;双语自托管说明定义启动、恢复和维护入口。
Criterion Disposition Implementation / evidence
固定源码/镜像、可重复分发、LICENSE/NOTICE implemented builder、两次归档逐字节相同、实际镜像 919 文件来源核对
真实 PG16/TLS、受限角色、私有凭据与持久身份 implemented 原 TypeScript owner、Compose/provision/launch
默认创建/完成操作的历史恢复和幂等 implemented 真实 PG/TLS 提交后丢响应、重启、严格 CLI 恢复与无重复效果
打包演练可容忍宿主/服务时钟偏差 implemented 旧版落后反例失败;新驱动领先、落后两臂全程通过
可信写者交接与受限读者默认拒绝 implemented 原 v0 写入口、#8861 v1 只读入口及实际演练
备份恢复、升级和轮换说明 implemented 双语 README 覆盖两卷、notBefore、重启就绪与三路读回,已在本地独立 PostgreSQL/TLS 实测
资源级写隔离、双物理宿主、云采用、默认 provider 推广 deferred 沿既有 #8747 / R6 验收

Scope And Continuation

模板复用现有 PostgreSQL、事务、Todo、lease 与 ACL owner。创建回执解码同时供本地创建命令与远端历史响应使用,持久化格式和原回执不变。演练的时间修复位于现有驱动,没有新增时钟服务、状态机或轮询层;相对等待完整租期,保持有界且保守。

a/b 是 v0 可信范围级写客户端,可以读取同范围其他任务;v1 reader 仅获具体 Goal 实例及资源的 read/snapshot,不取得写权限或历史操作回执。数据库不发布端口,客户端不加入 backend 网络或持有数据库凭据。TLS 覆盖客户端到网关;数据库使用隔离 backend 网络。

关闭示例仅停止自己的 Compose 项目。恢复要求新项目和空目标卷。资源级写隔离、物理双机、正式安装采用、CA 或数据库口令轮换和长期运行仍由原 shared-authority 工作验收。

Validation

  • 当前候选 1286bcbf89ac35b4fdafeddb44b5988ebe523ae6,验证基线 c3e3ac56586fbbc686e3e2d01b979fe59a62dd19。两次打包逐字节相同,归档 SHA-256 806f5e9b6c782f1c25468d5db96e0f9c1c17b14e5add122e2f55b809286987d6,内嵌 917 个源码文件匹配 Git。中英运维说明均在实际归档中。
  • 原生 arm64、PostgreSQL 16.16、Docker 29.5.2 / Compose 5.7.1,隔离环境 2 vCPU、3 GiB 内存和 12 GiB 数据盘。在 5e7c250a29 首次启动耗时 184.69 秒。提前核验拒绝尚未生效的证书,原网关继续响应。新证书通过既有 CA 校验后才切换两卷。重启刚返回时观察到 TLS EOF,两个服务健康后均出示新证书,三路客户端读回同一任务。最终文档补足了等待健康的步骤。
  • 当前候选的应用源码正文与该轮换演练逐文件相同。在缓存基础镜像的空项目启动并完成三路真实 TLS 读回用时 23.62 秒,镜像 revision 与当前头一致。计时边界分别为镜像、容器及客户端的实测路径。虚拟机准备另计。
  • 包测试 2 项通过。补齐锁定的 npm 开发依赖后,本地 premerge 19 项通过,RFC 双语门和公开边界检查通过。当前候选待独立复评。CI 等待按项目约定跳过。

Previous reviewed runtime evidence

独立评审通过的 2b4b1f5 还补做了凭据轮换和九卷备份恢复。47.32 MiB 的合成归档用时 7.85 秒,空项目恢复到原回执读回、旧凭据拒绝和卷覆盖拒绝用时 30.02 秒。

  • Tested head / runtime source pin: 2b4b1f54e5b2d53c6c0a86bfc4a12ad73552b884.
  • Compared target snapshot: a92b123749e7d2ef0c80e33fa88e40a4c0f572aa.
  • Run state: finished. Inputs: synthetic / public_fixture.
Check kind Result Evidence / limitation
regression_parity passed 同一真实 PG/TLS 包,旧驱动在宿主落后 9.551 秒时于原 21 秒断言失败;新驱动用服务端到期与更新时间求租期,没有放宽上限
real_entrypoint passed 新驱动在观测宿主落后 8.952 秒、领先 10.232 秒两臂完成全程;20 秒租约、早接管拒绝、到期接管、旧持有人拒写、重启后创建/完成原回执恢复、无重复重放、读者过滤及撤权保持
real_backend passed PG16.16/TLS 远程及 File/SQLite/PostgreSQL 创建套件合计 59 项,零跳过;含实际提交后丢响应、错误 Actor、改变意图及严格响应校验
static / unit passed 2 个包测试、两 Python 文件 Ruff、control-plane typecheck、3 MJS/3 shell 入口语法、公开边界、语义差异 advisory 和 RFC 双语门
real_entrypoint passed 隔离 Linux VM,2 CPU / 3 GiB,Rosetta amd64;两臂缓存条件首次客户端读回 46.3 / 31.1 秒,完整演练 229.1 / 170.0 秒
static passed 精确头两次归档字节相同;实际 amd64 镜像内 919 个源码/模板文件与固定归档逐项匹配,revision label 对应本头
manual passed 完整 18 路径复用/简化审阅;严格质量回执 cqr_e6d8183ee9e3dcd0cedd 对精确基线/头有效,1 次有界修复,0 blockers;本地 standard premerge 的 5 direct + 19 选中检查通过,0 failure / warning / manual hold

首次单独预取 PostgreSQL 用 22.5 秒、构建用 63.3 秒;上述缓存读回时间不包含它们或 VM 准备,不能据此宣称完整冷启动成本改善。两臂时长受本地环境影响,不作性能比较。旧版预期失败和临时观测脚本的字段读取错误均保留;完成的原始运行记录用于恢复核验,没有重写为成功或重复执行已通过的一臂。

391802d 的冷启动 68.8 秒与完整备份恢复 28.9 秒保留为历史证据。新头没有重测整包备份还原、实际证书/密钥轮换、实体 amd64、双物理宿主、云部署或长期运行。该历史候选已独立复评,当前头采用上方验证和独立审阅。

Frontend / Visual Evidence

  • UI impact: none. 修改 CLI/Compose 示例、说明与既有历史响应;没有渲染页面或桌面布局改动。
  • First viewport / preview: N/A;实际包内 CLI 已验证,未安装到活动环境。

Shared-authority RFC fixture impact

没有改变普通 provider 选择、迁移、持久化记录或 legacy authority 投影。真实远端回归和创建三 provider 检查覆盖共享解码边界;本增量不宣称完成 R6 的全量生产规模、物理双宿主或采用验收。

Boundary Checklist

  • 公开差异及正文不含私有状态、凭据、原始日志、内部链接或本机路径。
  • 生成包、秘密、数据库和运行证据不进入 Git。
  • 未执行专有 benchmark 或修改活动环境。
  • 差异限于自托管入口及已复现恢复/演练缺陷。
  • 无 RFC 对和 UI 改动;本地差异门通过。
  • 所有作者提交含 DCO Signed-off-by。

…g example

Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent; model=gpt-6.1-sol; provider=OpenAI; declaration=runtime_reported; effort=max.

Request changes conclusion (author-owned PR; GitHub blocks formal self-review)

审阅提交:391802da82e0f50e86a3ec08ef00a25fe3612b8d,目标 main;完整 14 路径、976 行新增已核对。

动机 / Motivation

需要自行托管远程任务服务、让两个可信客户端交接任务的操作者。以前需要手工拼接数据库角色、TLS、策略和客户端;现在可从固定源码生成包并用统一入口启动、读回和恢复。本轮实测包可以启动并完成受限读、任务交接和备份恢复,但新增任务在响应丢失后的客户端恢复仍不可用。资源级写隔离、双物理宿主、云部署、轮换和长期运行仍由既有 shared-authority/R6 工作验收。本次不切换普通 File/SQLite provider,不安装到活动环境,也不授予合并或云资源操作权限。

改动思路 / Approach

保留现有 TypeScript 服务、PostgreSQL 事务及 Todo/lease 决策,把可重复归档、私有初始化、两个 TLS listener、三个客户端和多卷恢复组织成一个可停止的示例包。这是合理的运维增量;新建另一套 Core 或把只读 ACL 描述成资源级写隔离都不必要。可信 v0 写入口与资源级 v1 只读入口分离有实际权限依据。当前 PR 边界应是可重复启动、操作和恢复这一个完整入口,默认许可的操作也必须通过其公开恢复路径。

具体改动 / Changes

关键内容讲解

  • build_bundle.py::bundle 用完整 Git SHA 归档,保留 LICENSE/NOTICE、源码摘要和镜像 pin;我从本头重新生成包,并将实际镜像内 919 个源码/模板文件与输入逐字节对照,Node 为 24.21.0。
  • prepareSecretVolumes 保留初始化身份、私有凭据和撤权策略,prepareDatabase 复用现有 PG owner;launch.mjs 让独立凭据走真实 TLS 客户端。实库角色非 superuser、无 BYPASSRLS,五张租户表均开启并强制 RLS。reader 凭据用于 trusted listener 时拒绝。
  • state.sh 停止本项目后备份数据库与凭据卷,只向新项目空卷恢复。我验证了同身份、同状态和同历史回执读回,以及覆盖已有卷被拒绝。原生 rehearse.mjs 的到期接管、旧持有人拒绝、受限 snapshot、撤权重启和缺失/损坏策略路径也通过。

规范依据:docs/reference/remote-authority-task-service-v0.md,修订 31944d835466c29f18f843ea92de75b49e7c0c62。TLS_SCOPE、EXPLICIT_OPT_IN 已实现;ORIGINAL_RECOVERY 未满足下述反例;PHYSICAL_HOSTS 留在现有 shared-authority/R6 验收,不能用同机容器代替。

对主干的风险 / Risks

[P2] 默认的 todo_add grant 暴露了不能闭环的恢复路径。 provision.mjs:112 给 a 新增授权;我用实际 TLS 代理在数据库提交成功后丢弃响应,首次调用正确返回 ambiguous,任务随后可读。但按说明用同一完整命令运行 ./client.sh a recover,实际退出码是 1,结果为 unavailable / remote_authority_transport_uncertain。直接读取同一服务的 HTTPS 响应却是 HTTP 200、found:原创建回执的 result 缺少 changed,而 remote_authority_contract.ts::responseCommand 即使 historical=true 仍要求它是 boolean。

缺陷在捆绑的既有服务 owner,相关源文件相对目标主干未改;本 PR 新增的默认 grant 把它纳入新包的许可用户路径,不能只以旧代码为由宣称该路径可恢复。修复共享服务历史创建回执的投影并固定修复版本,或先移除模板默认 todo_add 授权并准确限定可恢复操作;保留原历史回执兼容。 验收需新增真实 PG/TLS 的 todo_add 提交后丢响应、恢复、重启和原身份重放,且不能降低客户端校验。现有演练只恢复 complete,归档测试与演练通过仍覆盖不到此例。

PASS:两个包测试、标准 premerge 的 5 项 direct/10 项 catalog/8 项 risk-profile 与公开边界检查、真实权限/恢复演练。FAIL:上述新增操作恢复。独立 aarch64 VM 冷启动到 listener 就绪为 59 秒,缓存演练到三个客户端读回约 16 秒;VM 准备未计入,也不代表其他机器的时延保证。首次宿主缺 Compose 插件及测试 VM DNS 问题保留为环境失败;最终使用该独立 VM 自带 Compose,未改示例源码。没有查询或等待远端 CI。

我的整体评价 / Verdict

REQUEST_CHANGES。打包与隔离运维本身有可用价值,代码量也有明确运行消费者;但 long_horizon 与 user_experience 在默认新增操作的不确定结果恢复上仍有回归,不能以其余绿色检查替代。修复共享 owner 或收窄默认许可后可按新精确头复评。检查的是 CLI/Compose 示例及 Markdown,没有改变渲染页面;未验双物理宿主、原生 amd64、云部署、轮换和长期运行。评审没有执行合并或活动安装。

English verdict: REQUEST_CHANGES — the reproducible package works, but its default todo_add permission exposes a committed-operation recovery response that the packaged client rejects.

…ose-acl-20261117

Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
@loopx-agent loopx-agent changed the title Add a reproducible PostgreSQL/TLS self-hosting example Add PostgreSQL/TLS self-hosting with recoverable task creation Nov 16, 2026

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent; gpt-6.1-sol; OpenAI; runtime_reported; effort=max

Request changes conclusion (author-owned PR; GitHub blocks formal self-review)
精确 head:492937e302f0537781c213b6bcf20147f329f1fc;实际 base:main@b12608d82bbf33d64f239e908d946cae360e556b。

动机 / Motivation

需要自行托管远程任务服务、让两个可信客户端交接任务的操作者。以前需要手工拼接数据库角色、TLS、策略和客户端;现在可从固定源码生成包并用统一入口启动、读回和恢复。原新增任务丢响应后的恢复已修复;完整打包演练仍会因宿主与服务时钟偏差而误报失败。不切换普通 File/SQLite provider,不安装到活动环境,也不授予合并或云资源操作权限。资源级写隔离、双物理宿主、amd64、真实云端、轮换和长期运行仍属后续原验收范围。

改动思路 / Approach

部署脚本只编排 PG/TLS;Todo、lease 与历史回执继续由原 owner 决定,新增恢复复用同一解码器,没有第二份状态机。当前 PR 边界:Standalone packaged operation plus existing create-result projection; no active-provider promotion or future distributed qualification. 这次没有通过放宽客户端校验修复旧问题,而是从原创建 owner 提取解码器,再在已校验原身份、actor 和请求摘要的历史恢复分支复用。恢复只重建返回值,不修改原回执或再次提交。部署入口减少操作者手工拼装;显式启动和既有策略仍是权限边界,不增加确认轮次。

具体改动 / Changes

完整改动共18条路径,+1062/-32:模板基础设施、三份文档、演练与回归,以及两个共享 TS 文件。按改动前 docs/reference/remote-authority-task-service-v0.md(revision b12608d82bbf33d64f239e908d946cae360e556b)核对:TLS_SCOPE implemented;ORIGINAL_RECOVERY implemented;SERVICE_CLOCK not_met;EXPLICIT_OPT_IN implemented;PHYSICAL_HOSTS deferred。v0 a/b 是可信 Goal 写者,v1 reader 仅资源受限读取;这不是资源级写隔离。

关键代码讲解

  • decodeCoordinationTodoCreateReceipt 复用原创建回执规则,校验 schema 和内外 Todo ID 后派生 changed=true。
  • RemoteAuthorityService.dispatch 仅处理匹配的 todo_add 历史回执,保留原 receipt SHA;身份、请求意图与 v1 证明边界不因投影而放宽。
  • rehearse.mjs 在早期 claim 已被拒绝后,用服务端到期时间减宿主 Date.now(),由此触发本轮新 P2。

对主干的风险 / Risks

[P2] 演练把两个时钟当成同一时间域。 新脚本对20秒租约断言剩余时长不超过21秒。实际 Docker VM 比宿主快约8.6秒时,观测到 updated_at=22:38:16Z、expires_at=22:38:36Z、宿主 22:38:09.730Z,计算出26270ms并在107行退出;三次原脚本均失败,不能把后续接管与重启检查记作通过。服务租约本身正确。保留全部断言与21秒上限,只将时长改由 expires_at-updated_at 计算的私有反事实副本,完整通过接管、stale owner、重启后原回执、读隔离及撤销。请在同一服务时钟域计算等待,或使用有界服务状态轮询;不要放宽阈值或修改租约权限。复验应覆盖宿主落后服务数秒的完整打包演练。

验证 本轮结果
真实 PG16/TLS:丢响应、重启、原身份恢复、重放及创建 owner PASS:43,0 skip
同一新测试、只恢复 main 两个 runtime 文件 预期负对照:创建恢复 child 失败并使 parent 失败;其余35通过;不是两个独立缺陷
协议/客户端测试、bundle 测试、TS typecheck PASS:16、2、typecheck
当前源码生成镜像 PASS:919个源文件及镜像 revision 与精确 head 一致,arm64
原打包演练 FAIL:跨时钟断言;单表达式反事实通过不等于原脚本通过
标准 premerge 技术项5 direct+10 catalog+8 risk+1 public-boundary通过;总体 FAIL:quality_receipt_missing

语义与 CI 对齐

复用现有词汇与 typed owner,没有新存储协议或普通 provider 默认切换。显式 off、正常本地创建、错误 actor/intent、受限读者不能写、恢复无二次副作用由当前本地真实入口与负例覆盖;没有查询或等待远端 CI。当前 native qualification receipt 缺失单独保留,没有伪造通过记录。此前对旧 head 的备份/还原与 RLS 实测仅作为相同字节脚本的历史证据复用,本轮没有声称重新完成所有备份资格。

我的整体评价 / Verdict

交付判断为 justified_increment:打包入口与原创建恢复有实质进展;long_horizon improved,user_experience regression,原因是当前公开演练入口尚会误报。共享解码器的简化有证据支持,部署编排与权限 owner 的划分合理;最小剩余修复是演练时间域计算。旧 missing-changed 发现已验证解决,不再沿用为当前阻塞。

检查的是新增 CLI/Compose 示例、共享回执投影和 Markdown,没有产品渲染页面或布局改动;没有以浏览器或正式安装验收网页。双物理宿主、amd64、真实云端和长期运行仍未验证,不把这些未来范围变成新的当前阻塞。未合并、未安装或提升活动 provider。

English verdict: REQUEST_CHANGES — the original creation-recovery defect is fixed, but the packaged rehearsal fails under measured host/service clock skew.

Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent — gpt-6.1-sol / OpenAI; runtime_reported; reasoning effort: max.

Approval conclusion (author-owned PR; GitHub blocks formal self-approval)

审查提交:2b4b1f54e5b2d53c6c0a86bfc4a12ad73552b884。没有遗留阻塞发现。此前创建恢复与时钟问题均以真实 PostgreSQL/TLS 路径复验。

动机 / Motivation

受影响的是希望自托管远程任务服务、让两个可信客户端交接工作的操作者。以前要手工协调数据库角色、证书、策略与客户端;如果创建提交成功但网络回包丢失,旧的历史响应还会被严格客户端拒绝。现在可以从固定源码启动可复现的服务,用原请求找回历史回执,并在重启后确认同一任务及无重复写入。本次交付独立 Compose 模板与既有创建回执的恢复投影,不改变普通本地 provider 的选择。资源级写隔离、实体双宿主、生产部署、轮换和长期容量验收仍沿原 shared-authority 工作推进。

改动思路 / Approach

服务职责沿原边界分工:模板编排 PG 与 TLS,现有 TypeScript 服务校验调用者、范围和原请求,Todo 与 lease owner 决定能否修改状态,PG 原子提交并存储回执。只新增手工部署说明不能提供可重复启动与恢复路径;放松客户端对响应的检查会掩盖真正的不完整结果。复用原创建回执解码器能补齐返回值,保留原回执本身及摘要。演练脚本只等待由服务器两次时间戳推导的租期,权限仍由服务端判定,成本是一次保守且有上限的等待。

部署脚本只负责编排,创建历史响应沿用原解码器,租约时间仍由服务拥有。当前边界是可单独启动、验证及停止的 Compose 包和小范围恢复兼容修复。

具体改动 / Changes

以 Remote authority task service v0 在 c9d8616 的约束为基准。TLS_SCOPE:独立凭据、库角色限制与 v1 资源读边界;ORIGINAL_RECOVERY:原身份、意图、回执摘要及无二次写;SERVICE_CLOCK:服务端到期和当前租约决定接管;EXPLICIT_OPT_IN:示例通过明确命令启动,普通本地入口不切换;PHYSICAL_HOSTS:本地隔离验证与实体双机、云和生产采用分开,后续仍需实测。全文把 18 路径与远端文件列表核对,当前差异 +1063/-32;从上一审查头到本头只有演练脚本变化。

关键代码讲解

  • bundle 从完整提交取运行源码,将 digest 和版本放入包内。Docker 先检查 digest,再解包和装依赖;两次归档逐字节相同,镜像内 917 个归档成员均与原文件一致,另有模板拷入的启动与配置源码。
  • prepareDatabase 通过原 schema/role owner 配置受限角色,只给新隔离范围创建或绑定初始任务;重复启动读取既有身份,不重置政策或数据。
  • RemoteAuthorityService.dispatch 先核验原 principal、Actor 与请求摘要,再在匹配的历史 todo_add 结果上调用 decodeCoordinationTodoCreateReceipt,与本地创建用同一解释。changed 是返回投影中从原回执推导的事实;不会重写回执或在读回时再创建。
  • rehearse.mjs 的续租及接管分支 检查提前接管失败,使用 expires_at 减 updated_at 取得正数且不超过 21 秒的等待量,到期后才验证新 epoch 及旧持有人不能再写。

对主干的风险 / Risks

复验 结果
同一解包镜像、同一 20 秒租约、模拟宿主时钟偏差 旧脚本在宿主慢 10 秒时触发 21 秒断言;新脚本在快、慢 10 秒两臂均跑完原断言、接管、重启、回执、重放、资源读拒绝与撤权。缓存镜像下新卷读回约 14 秒,只代表本次隔离环境。
真 PG16/TLS 与本地创建 59 项通过,零跳过;包含 File、SQLite、PG 创建,实际提交后丢响应并重启,看到了原摘要和无重复写入。历史基线仅还原两份共享运行文件的反例仍保留:严格客户端无法读取创建回执。
打包与备份恢复 2 个打包测试、TS 检查、重复归档与镜像文件核对通过。复验另一个空项目恢复后相同任务、身份与回执,并拒绝覆盖已有卷。读回五表强制 RLS,运行角色非 superuser 且无 BYPASSRLS,数据库端口未发布。
仓库检查 5 个直接和 19 个选中技术检查及公开边界扫描通过;独立运行缺当前工作区的质量回执,单列为本地合并资格限制。首次虚拟机构建遇到宿主盘满的 I/O 错误,恢复环境后按原命令重跑,保留该历史失败。

语义与 CI 对齐

复用已有类型和事务;错误 Actor、错误意图、越界读取、读者写入和撤权保持拒绝。v0 写者仍是信任范围级;v1 只读资源 ACL 不授予写或历史回执权。默认本地入口和已存回执的格式不变;历史恢复结果只扩充满足原严格响应检查的事实。未查询或等待远端 CI。实体 amd64、双机/云、长时间资源干扰、证书和密钥轮换均不得从本次 arm64 隔离演练推断。

我的整体评价 / Verdict

长程方面,丢响应后能重新确认原结果并接着交接,重启或同请求重放不重复应用。用户体验方面,明确分开的启动、可信写、限定读、恢复和备份入口减少了手工配置,并且失败不会扩大权限。检查的是实际 CLI 与 Compose 路径、数据库及隔离状态,未涉及产品渲染页面;截图不适用。

保持这一独立模板与共享回执修复的边界是合理的。旧演练时差问题已解决,正反例均可重跑;该批准限于当前源码和本地可重建包,并保留生产级资格缺口。

English verdict: APPROVE — the packaged PG/TLS path preserves original receipts and passes both host-clock offsets without weakening the lease or reader checks.

…oduct-pg-compose-acl-20261117

Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>
Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent; model=gpt-6.1-sol; provider=OpenAI; declaration=runtime_reported; effort=max.

Approval conclusion (author-owned PR; GitHub blocks formal self-approval)

动机

让已有Docker Engine与Compose的操作者从固定源码启动隔离的协同示例,并在提交后丢响应时恢复原创建回执。 使用自托管包的操作者和已有远端CLI调用者。主干的todo_add虽已提交,严格客户端恢复时仍退出1;候选复用创建owner解码,读回原Todo且不再创建或扣写一次。 真实 PostgreSQL16.15/TLS 与 File/SQLite 创建套件59项通过、零跳过;同一增强恢复用例在主干因todo_add恢复返回unavailable而失败。 双物理宿主、云部署、资源级写ACL、长期运行及正式安装采用未认证;本轮没有重做备份还原或密钥轮换,文档与其未变实现已读。

改动思路

复用现有PostgreSQL、Todo、lease、ACL与创建回执owner;Compose仅承载显式启动的示例。 当前交付边界:自托管示例与既有创建历史响应的共享解码。 创建解码仍由 Todo create owner 提供;远端只在原 principal、actor、request digest 已匹配后投影历史响应。归档、凭据初始化与 Compose 不成为新的准入或业务状态 owner。

具体改动

本次完整核对18条改变路径及原评审后的差异;当前头为 1286bcb。 固定归档917个源码文件和9个模板逐项匹配,归档摘要与作者当前声明一致;两项打包回归通过。 共享解码 · 原回执恢复

真实 PostgreSQL16.15/TLS 与 File/SQLite 创建套件59项通过、零跳过;同一增强恢复用例在主干因todo_add恢复返回unavailable而失败。 主干对照使用相同增强后的真实集成用例;失败是创建恢复子用例及其父测试,没有把父失败算成第二个独立缺陷。 断言包括原回执摘要和字节、原数据库状态、错误actor及更改意图的拒绝,既有合法流程和File/SQLite创建也通过。

精确归档917个源码文件和9个模板逐项匹配;实际Colima/aarch64包完成启动、接管、创建/完成历史恢复、重启重放、读者过滤、拒写和撤权,自己的容器与卷已退出。 受限数据库角色、两可信写客户端与额外只读客户端通过实际包入口运行;20秒租期和21秒断言上限保留,过早接管仍拒绝。 本机从启动入口到两客户端首次读回93.9秒,包含本次镜像拉取与构建;不是性能比较,测试工具准备另计。

本机起初缺Compose插件,使用官方校验摘要的临时工具补齐后运行;未修改全局配置。严格核心类型检查和当前主干目标的本地premerge通过,5项直接检查及19项选择检查均无失败;按约定未查询CI。

对主干的风险

共享解码必须兼容已有正常创建和重放;File/SQLite/真实PG对照未发现回归。只读授权必须不因新任务出现或改身份而扩展,实际包验证了未列资源、未来任务、四类scope替换、拒写与撤权持久性。 v0的a/b仍是可信Goal范围写者,不能把v1读者ACL说成资源级写隔离;文档已明确区分。双物理宿主、云部署、资源级写ACL、长期运行及正式安装采用未认证;本轮没有重做备份还原或密钥轮换,文档与其未变实现已读。

我的整体评价

批准这个有界自托管与恢复切片。本地自托管与原操作恢复形成可使用的闭环;未把一次本地演练当作多主机或默认provider采用。 复用现有PostgreSQL、Todo、lease、ACL与创建回执owner;Compose仅承载显式启动的示例。 自托管示例与既有创建历史响应的共享解码。 按 docs/reference/remote-authority-task-service-v0.md 在 c3e3ac5 的 RECOVER_ORIGINAL_OPERATION、SCOPE_AND_DEFAULT、PACKAGED_JOURNEY 核对;没有借此宣布R6或云采用完成。

English verdict: APPROVE at 1286bcb. Real PG16/TLS recovery, unchanged-receipt replay, scoped denial and the source-pinned packaged journey pass; physical-host and rollout qualification remain separate.

@huangruiteng huangruiteng left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · Codex · OpenAI · self_reported

动机 / Motivation

需要自托管远程 Todo authority、让两个受信客户端交接任务的操作者,过去必须手工拼接 PostgreSQL 角色、TLS、策略、客户端和恢复路径。更容易出错的情况是创建事务已经提交但 HTTP 响应丢失:旧客户端只看到 unavailable,无法从原操作确认已经创建的任务。

当前提交提供固定源码、可重复打包的 Compose 示例,并让历史 todo_add 回执复用原创建 decoder 投影出客户端所需的完整结果。操作者可以从原请求恢复同一个 Todo,不重复写入;普通 File/SQLite provider 不会因此切换到 PostgreSQL。本次边界是可单独启动、验证和停止的自托管示例,不包含双物理宿主、云部署或正式安装推广。

改动思路 / Approach

部署脚本只编排 PostgreSQL、TLS listener、策略和卷;Todo、lease、ACL 与回执仍由现有 TypeScript owner 决定。RemoteAuthorityService.dispatch 在匹配原 principal、actor 和 request digest 后,仅对历史创建回执调用共享 decoder,不重写持久回执,也不把恢复读变成第二次提交。

演练脚本使用服务自身的 expires_at - updated_at 计算租期等待,避免把宿主与容器时钟当成同一时间域。v0 的 a/b 仍是受信 Goal 级写者,v1 reader 的资源 ACL 只负责受限读取;文档没有把只读 ACL 说成资源级写隔离。

操作 当前 head 的结果
创建成功但响应丢失 原请求恢复同一回执和 Todo,不重复写入
服务重启后重放 返回历史结果,canonical state 不变
错误 actor、意图或 tenant 原准入边界拒绝,不产生写入
reader 尝试写入 v1 只读边界拒绝

具体改动 / Changes

完整差异为 18 个文件、+1063/-32:Compose/TLS/卷与演练模板、三份文档、共享创建回执 decoder、remote service 历史投影和集成测试。实际 merge base 为 c3e3ac56586fbbc686e3e2d01b979fe59a62dd19,没有正文所称的默认 provider 切换。

关键代码讲解

  1. build_bundle.py 从完整 Git SHA 生成可重复归档,保存 LICENSE/NOTICE、源码摘要和镜像 pin;错误 revision 或已有输出会拒绝覆盖。
  2. provision.mjs 复用原 PostgreSQL schema/role owner 初始化受限身份、策略和资源,不新建业务准入状态。
  3. decodeCoordinationTodoCreateReceipt 校验 schema、operation、Goal/Todo 身份后派生 changed=true;原 receipt 字节保持不变。
  4. RemoteAuthorityService.dispatch 只在身份与请求摘要匹配的历史 todo_add 分支投影该结果,其他命令仍走原 owner。
  5. rehearse.mjs 用服务时间戳计算有上限的等待,并继续验证 early takeover 拒绝、旧 holder 写拒绝、重启恢复、reader 过滤和撤权。

规范依据为 docs/reference/remote-authority-task-service-v0.md,精确 revision c3e3ac56586fbbc686e3e2d01b979fe59a62dd19。TLS_SCOPE、ORIGINAL_RECOVERY、SERVICE_CLOCK、EXPLICIT_OPT_IN 与 PACKAGED_JOURNEY 在当前切片中有对应实现;PHYSICAL_HOSTS、生产云部署、资源级写 ACL 与长期轮换留在后续验收。

对主干的风险 / Risks

PASS:在隔离真实 PostgreSQL 16.16 上运行 todo_create_reviewed.test.ts 与 remote_authority.integration.test.ts,43 项通过、0 跳过。覆盖真实 TLS、直接提交后丢响应、服务重启恢复、同请求重放、lease takeover、撤权和 File/SQLite/PG 创建。compose bundle Python 测试 2 项通过,control-plane TypeScript typecheck 通过。

主要风险是历史创建响应的共享解码。实现复用原 decoder 并校验原身份,不接受放松后的客户端 schema;正常创建和重放也在同一 suite 中通过。仍未验证双物理主机、真实云网络、生产证书轮换、长期资源干扰和资源级写 ACL,不能从单机 PG/TLS 测试推断这些资格。

我的整体评价 / Verdict

APPROVE。该 PR 在明确的自托管边界内形成了可用闭环:可复现包、受限数据库身份、TLS 入口、原操作恢复和重启重放均有真实路径证据。共享 decoder 修复了丢失响应后的用户恢复,同时保留原回执与权限边界;尚未验证的多宿主机、云和正式采用范围已单独披露。

English verdict: APPROVE at 1286bcb. Real PostgreSQL 16.16 plus TLS proves creation recovery, restart replay, lease fencing and scoped denial; physical-host and production rollout qualification remain separate.

@huangruiteng
huangruiteng merged commit a81dbbf into main Nov 17, 2026
42 of 52 checks passed
@huangruiteng
huangruiteng deleted the codex/product-pg-compose-acl-20261117 branch November 17, 2026 07:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants